home *** CD-ROM | disk | FTP | other *** search
/ Nebula 1 / Nebula One.iso / Internet / PPP_Installation_Kit / PPP-2.2-0.4.6-pkg / README.NeXT.MAB.Installation < prev   
Text File  |  1995-11-29  |  34KB  |  783 lines
  1. #
  2. #  $Id: README.NeXT.MAB.Installation,v 4.2 1995/11/30 02:01:44 perkins Exp $
  3. #
  4.  
  5. This distribution contains a MAB installer package for ppp-2.2.
  6. Only the binaries are distributed with this package. The full
  7. source code is available from:
  8.  
  9.   ftp://ftp.thoughtport.com/pub/next/ppp/
  10.    -or-
  11.   http://www.thoughtport.com:8080/PPP/
  12.  
  13. For problems, please mail nextppp@listproc.thoughtport.com.  Make
  14. sure you read the TROUBLESHOOTING section below so that you send all
  15. the appropriate information.
  16.  
  17. For more information on PPP in general, you might want to check out:
  18.    http://cs.uni-bonn.de/ppp/faq.html
  19.      -and-
  20.    ftp://morningstar.com/pub/papers/ppp-white-paper.ps.gz
  21.      -and-
  22.    http://www.cis.ohio-state.edu/hypertext/faq/usenet/pdial/faq.html
  23.        (This last is a list of internet providers)
  24.  
  25. If you have questions or problems, please mail Steve Perkins
  26. <perkins@cps.msu.edu>.
  27.  
  28. Installation Instructions
  29. =========================
  30.  
  31. The installer setup was designed to allow you to easily install PPP as
  32. well as to easily upgrade to future releases.  A full description of
  33. the installation structure is described later under the section
  34. "Directory Structure".  However, you don't need to read this section
  35. in order to get PPP working.
  36.  
  37. The procedure for an initial installation and for an upgrade are very
  38. similar. However, if this is the first time you are installing PPP,
  39. there are a few extra steps that you must do for the initial setup.
  40. They will be described later in this document.
  41.  
  42. Everybody must install the PPP package (using the NeXT Installer.app)
  43. regardless of whether this is an initial installation or an upgrade.
  44. This installation must be done as root.  The installer will place
  45. ppp-2.2 in a new directory /usr/local/ppp.  If this directory already
  46. exists and _does not_ contain a previous version of ppp-2.2 that was
  47. installed with the installer package, you might want to think about
  48. moving it before you use the installer package.  If the directory does
  49. exist and does contain a previous version of PPP that was installed
  50. with the installer, it is safe to perform the upgrade.  You will not
  51. lose any existing files.
  52.  
  53. If you are performing an upgrade, you are almost done after
  54. successfully using the installer. All you need to do is to edit
  55. /etc/rc.local (as described below) and add code to load the new BPF
  56. relocatable code.  Then, you must reboot your machine so that the new
  57. loadable kernel server (LKS) is loaded. You should be able to start
  58. the upgraded PPP just like normal.  If this doesn't work, see the
  59. "Troubleshooting" section later on.
  60.  
  61.  
  62. Extra Steps for Initial Configuration 
  63. =====================================
  64.  
  65. If this is the initial installation of PPP, there are several system
  66. administration steps that must be performed.  These only need to be
  67. done once.  These steps do not need to be re-performed for an upgrade.
  68.  
  69. 1) Before PPP can successfully run, a module called the loadable
  70.    kernel server (LKS) must be linked into the system.  This is 
  71.    something that must be done each time the computer boots up.
  72.  
  73.    So that you don't have to do this by hand each time the machine
  74.    boots, you should modify a file called /etc/rc.local.  Since 
  75.    this is a system file, you must be root to perform the
  76.    modification.
  77.  
  78.    This file contains code that is run each time the machine is
  79.    started.  This is the standard place where "local" modifications 
  80.    are made to the system.  First, make a backup copy of /etc/rc.local
  81.    (maybe named /etc/rc.local.prePPP).  It will be available in case
  82.    you accidentally mess up the file.  Then, using vi or your favorite
  83.    editor, place the following lines (not including the ==...==
  84.    separators ;) somewhere near the end of the file /etc/rc.local:
  85.  
  86. ======================================================================
  87. #
  88. # Load the Berkley Packet Filter LKS
  89. # This must be done before PPP.  Comment this out
  90. # if you disabled BPF. If you use BPF, you _must_ 
  91. # load it before the PPP LKS.  If you chaged pathnames
  92. # in the Makefile, make sure the appropriate paths are
  93. # used below.
  94. #
  95. if [ -f /usr/local/bpf/reloc/bpf_reloc ]; then
  96.        /usr/etc/kl_util -a /usr/local/bpf/reloc/bpf_reloc
  97. fi
  98.  
  99. # 
  100. # Load the selected version of the PPP-2.2 loadable
  101. # kernel server (LKS).
  102. #     
  103. if [ -f /usr/local/ppp/reloc/ppp_reloc ]; then
  104.     /usr/etc/kl_util -a /usr/local/ppp/reloc/ppp_reloc > /dev/console 2>&1
  105.     (echo -n ' ppp')    > /dev/console
  106. fi
  107. ======================================================================
  108.  
  109.   This code will now be executed next time you reboot your
  110.   machine.  You can verify that this was executed by checking
  111.   the output of /usr/adm/messages upon a successful reboot.  There
  112.   should be a section of output that says the PPP-2.2 LKS was 
  113.   successfully loaded.
  114.  
  115.  
  116. 2) The installer package places things in a directory called
  117.    /usr/local/ppp.  There are several subdirectories under this
  118.    directory.  However, these directories are not part of the standard
  119.    UNIX Path.  The UNIX Path is a list of directories that UNIX searches 
  120.    when it is trying to find a command.  There are two solutions
  121.    to fix the problem.  You may either add specific PPP directories to
  122.    the current path (must be done for each individual user), or you
  123.    may add important files to a directory that is already in the
  124.    standard path.  I believe the second approach is the better
  125.    solution.  
  126.  
  127.    This step is optional, but highly recommended.  As root,
  128.    execute the following commands to add important files
  129.    to directories that are already in the Standard UNIX path:
  130.  
  131.    /bin/mkdirs -o root -g wheel -m 755 /usr/local/bin /usr/local/man/man8
  132.    ln -s /usr/local/ppp/bin/* /usr/local/bin
  133.    ln -s /usr/local/ppp/man/man8/* /usr/local/man/man8
  134.  
  135.    Some or all of the 'mkdir' commands may fail if the directories
  136.    already exists.  This is OK.  Futher, to get the man program to
  137.    understand that you have added some pages to the /usr/local/man 
  138.    directory, you need to make sure that the environment variable
  139.    MANPATH includes the /usr/local/man entry.  In my .cshrc file
  140.    I have an entry that looks like:
  141.       setenv MANPATH "/usr/local/man:/usr/man:.:.."
  142.    See 'man man' for more information.
  143.  
  144.    Once these commands are executed, the programs pppd, pppstats, and
  145.    chat (along with their respective man pages) will become available
  146.    to you from the command line.  However, before you can immediately
  147.    see them, you may need to log out and log back in.
  148.  
  149.  
  150. 3) Once you start trying to make PPP connections, it is important
  151.    to have access to the logging information that PPP generates. This
  152.    will allow you to follow the progress of PPP and will aid in
  153.    diagnosing problems.  The user level process 'pppd' outputs
  154.    logging information by using the standard UNIX syslog facility.
  155.    Part of this facility allows you to select how much (i.e.
  156.    what level of verbosity) and where (i.e. to which file) this
  157.    information will be placed.  While the following step is optional,
  158.    it is highly recommended.
  159.  
  160.    As root, make a backup copy of /etc/syslog.conf.  You may wish
  161.    to call it /etc/syslog.conf.prePPP.  If you run into problems with
  162.    the system logging error messages, you can replace /etc/syslog.conf
  163.    with the original, reboot, and then you should be back to normal.
  164.  
  165.    Now, as root, use vi or your favorite editor to edit the file
  166.    /etc/syslog.conf.  You need to add the line:
  167.  
  168.        local2.debug        /usr/adm/ppp2.2.log
  169.  
  170.    It is _imperative_ that you place a <tab> character
  171.    between the level "local2.debug" and the file name
  172.    "/usr/adm/ppp2.2.log".  Do _not_ use spaces. If your
  173.    editor converts tab characters to spaces, you need to
  174.    use a different editor.  Also beware of cutting and pasting
  175.    between buffers.  Sometimes a tab will be converted to spaces
  176.    during that operation. Below is the actual contents of
  177.    my /etc/syslog.conf:
  178.  
  179. ======================================================================
  180. local2.debug                    /usr/adm/ppp2.2.log
  181. *.err;kern.debug;auth.notice            /dev/console
  182. kern.debug;daemon,auth.notice;*.err;mail.crit    /usr/adm/messages
  183. mark.debug,daemon.info                /usr/adm/messages
  184. lpr.debug                    /usr/adm/lpd-errs
  185. mail.info                    /usr/spool/mqueue/syslog
  186.  
  187. *.alert;kern.err;daemon.err            operator
  188. *.alert                        root
  189.  
  190. *.emerg                        *
  191. ======================================================================
  192.  
  193.    Once you have modified /etc/syslog.conf, you then need to perform
  194.    one more step.  You need to actually create an empty logging file.
  195.    This step is necessary because if syslog does not see the file, it
  196.    will not create it.  So, removing the file is a handy way to turn
  197.    off the logging.  To create an empty logging file, as root execute:
  198.  
  199.         touch /usr/adm/ppp2.2.log
  200.  
  201.    Upon a successful reboot, logging will be enabled for pppd
  202.    (remember to specify the 'debug' option to pppd to get reasonable 
  203.    information sent to the logging file).
  204.  
  205.  
  206. 4) If you have a standalone machine, it is necessary for you to make
  207.    sure your system is configured to correctly support a network.  The
  208.    following steps will help in correctly configuring your machine.
  209.    Please note, if you do not have a standalone machine (i.e. you are
  210.    on a local network), you need to speak with your system
  211.    administrator to determine the proper configuration for your
  212.    machine.  The following only applies to standalone machines.
  213.  
  214.    It is suggested that you reboot your machine _before_ you start 
  215.    these procedures.  This is to verify that you successfully
  216.    completed the previous steps and that your machine does indeed
  217.    reboot.  If it doesn't, you should replace /etc/rc.local with the
  218.    backup copy and reboot.  Then, determine why your modifications
  219.    failed.  After successfully rebooting, you are ready to move on to 
  220.    these steps.
  221.  
  222.    As root, make a backup copy of /etc/iftab.  You might name it
  223.    /etc/iftab.prePPP.  Then, modify this file by adding the line:
  224.   
  225.     lo0     inet    127.0.0.1 netmask 0xff000000 -trailers up
  226.  
  227.    right before the -1- entry that already exists in the file.  The
  228.    finished file should look similar to (minus the ---- separators):
  229.    ----------------------------------------------------------------------
  230.  
  231.    lo0     inet    127.0.0.1 netmask 0xff000000 -trailers up
  232.    -1-       inet       -HOSTCONFIG-
  233.    *       inet       -AUTOMATIC- netmask -AUTOMATIC- -trailers up
  234.  
  235.    ----------------------------------------------------------------------
  236.    Please note that the file  probably has a bunch of comments
  237.    at the top (lines that start with #).   I left those out in the
  238.    example above so I could save space.  They of course, can remain
  239.    in your copy.
  240.   
  241.    As root, make a backup copy of /etc/hostconfig.  You might
  242.    name it /etc/hostconfig.prePPP.  If, after the following steps, you
  243.    run into problems booting your machine, you may replace
  244.    /etc/hostconfig with the backup and you should be able to
  245.    successfully reboot.
  246.  
  247.    Start up the HostManager.app (under /NextAdmin).  After
  248.    successfully entering the root password, you should get the
  249.    HostManager Menu.  Select the "Local..." menu option to get the
  250.    main window.  Modify it as follows: 
  251.  
  252.        For "NetInfo Binding", select "use local domain only"
  253.            and make sure the box for "Readable only by local net" 
  254.            is checked.
  255.  
  256.            For "Hostname", fill in your host name as appropriate.  Do
  257.            _not_ add the domain name.  For example, use "sidney"
  258.            rather than "sidney.cps.msu.edu". 
  259.  
  260.            For "NIS Domain Name", select "None"
  261.  
  262.            For "Internet Address", use the provided IP address
  263.            (probably 127.0.0.1) unless your system administrator has
  264.            assigned you your own unique IP address.  In this case,
  265.            reverify that you are a standalone machine.
  266.  
  267.            For "Broadcast Address", select "Default"
  268.     
  269.        For "Time Standard", select "Ignore Network Time"
  270.  
  271.            For "Netmask", select "Default"
  272.  
  273.            For "Router", select "None"
  274.  
  275.   When this is complete, click the "Set" button.   You will then have
  276.   the option to reboot or to skip the reboot.  Choose the appropriate 
  277.   action.  It is suggested that you reboot immediately and verify that
  278.   your system does indeed reboot (and behave as normal).  If it
  279.   doesn't, replace /etc/hostconfig with the backup copy and then
  280.   reboot.  Once you are back up, determine the problem with your
  281.   configuration. 
  282.  
  283.   Please note that this description is generic and will work in most
  284.   cases.  There are lots of variations that people can and will need 
  285.   to make. Your network administrator will be able to provide you with
  286.   the correct details for your particular site.
  287.  
  288.  
  289. Congratulations!  You have successfully installed PPP and are now
  290. ready to start up a connection.  See the section "Initial Testing" for
  291. steps to verify that PPP works on your system.  
  292.  
  293.  
  294. Initial Testing
  295. ===============
  296.  
  297. One of the most notoriously difficult portions of getting PPP links up
  298. and running involves writing the script that automatically dials your
  299. modem, connects to the peer, and starts the remote ppp process.  Once
  300. you are connected to the peer, each PPP process will start
  301. communications and things become much easier.
  302.  
  303. Before you dive into script writing, there is a simpler solution that
  304. will allow you to test the ppp portion.  Once this works, getting the
  305. dial scripts to work is a matter of sheer determination!
  306.  
  307. The mechanism is this... use a communications package (tip or kermit
  308. are good choices) to manually dial the modem and log into the remote
  309. server.  There, manually start up the pppd process (the remote
  310. process, once started, will probably print some garbage on the screen.
  311. You can ignore this). Once this is done, you can exit the
  312. communications process (to free up the device it is using).  Then,
  313. start your local pppd on the same device.  The pppd processes will
  314. then start communicating.  The premise is that you manually perform
  315. the operations that you would like your dial script to automatically
  316. perform.  Once you _know_ ppp works, you can spend time on the dial
  317. scripts.
  318.  
  319. Please note, you _must_ exit from your communications program before
  320. you start your local pppd.  For example if you are in kermit and you
  321. start the peer pppd process by hand, you must completely exit kermit
  322. before you start pppd.  If you don't, the connection will not form.
  323. Further, if you find that when you exit, your modem immediately hangs
  324. up, you need to instruct the modem to ignore DTR.  There is an AT
  325. command that will do this (AT&D on Supra), but you will need to check
  326. your modem manual to determine the correct command.
  327.  
  328. If you are planning on using kermit, Stephane I. Matis
  329. <petergun@vectrex.login.qc.ca>, has supplied this excellent definition
  330. that you may place inside your .kermrc file to help with PPP testing:
  331. ----------------------------------------------------------------------
  332. set term byte 8
  333.  
  334. # define pppd 
  335. define pppd -
  336.         !pppd < \v(line) > \v(line) defaultroute
  337. ----------------------------------------------------------------------
  338.  
  339. To use this, add the above to your ~/.kermrc file (minus the '---...---'
  340. separators).  Then start kermit.  After you have started the remote PPP
  341. server by hand, return back to your local kermit prompt and execute
  342. the command 'do pppd'.  In this particular circumstance, you will not
  343. need to exit from kermit.
  344.  
  345. Before you start initial testing, you may want to read the pppd man
  346. page.  This will allow you to familiarize yourself with the some of
  347. the options available to you for starting your local pppd.
  348.  
  349. Of particular interest for most people is the 'defaultroute' option to
  350. pppd.  If you have a standalone machine, then all your foreign traffic
  351. must go to the peer.  Adding the 'defaultroute' option to pppd
  352. instructs pppd to set your system up in such a manner.
  353.  
  354.  
  355. Determining if the link is actually up
  356. ======================================
  357.  
  358. There are several ways to determine if the link has actually been
  359. established.  I will go through some of them.
  360.  
  361. 1) You may look at the pppd log file (typically
  362.    /usr/adm/ppp2.2.log).  If you see lines that look similar to:
  363.  
  364.     Jan 11 23:13:38 sidney2b pppd[2141]: local IP address 35.9.12.55
  365.     Jan 11 23:13:38 sidney2b pppd[2141]: remote IP address 35.9.10.13
  366.  
  367.    You are probably up.
  368.  
  369. 2) You may check the status of the PPP interface.  Using the command:
  370.      /usr/etc/ifconfig ppp0
  371.  
  372.    You should see that the interface is UP and that there are valid
  373.    IP addresses assigned to it (0.0.0.0 is not valid).  Here is an
  374.    example of what you might see:
  375.  
  376.     ppp0: flags=51<UP,POINTOPOINT,RUNNING>
  377.             inet 35.9.12.104 --> 35.9.10.14 netmask ff000000 
  378.  
  379. 3) You may check the routing.  When the connection comes up, you
  380.    should get at least one route to the new interface.  If you
  381.    specified 'defaultroute' to pppd, you should also see a default
  382.    route.  The command for checking routes is 'netstat -rn'.  Here
  383.    is an example of what you might see:
  384.  
  385.     Routing tables
  386.     Destination      Gateway            Flags     Refs     Use  Interface
  387.     127.0.0.1        127.0.0.1          UH          2      558  lo0
  388.     35.9.10.14       35.9.12.104        UH          0        0  ppp0
  389.     default          35.9.10.14         UG          2       25  ppp0
  390.     192.42.172       192.42.172.1       U           6     1939  en0
  391.  
  392.  
  393.   In the above case, the peer is 35.9.10.14 and my local machine has
  394.   been assigned 35.9.12.104.  All foreign traffic goes through the
  395.   default route to the peer.
  396.  
  397.   If you don't have an ethernet card installed on your system, you
  398.   will not have an 'en0' interface.
  399.    
  400.   
  401. The routing issue is important.  Discussion of this issue is outside
  402. the scope of these instructions, but I thought it might be beneficial
  403. to list a few other important tools that may help you out.  The man
  404. pages can give more details:
  405.  
  406.   /usr/etc/ping           - send packets to an IP address or hostname
  407.   traceroute          - Show the route to a particular machine
  408.  
  409. The IP address that you use can be negotiated automatically in PPP.
  410. Unlike SLIP, you do not have to specify an IP address when the link is
  411. brought up.  If no address is specified as an argument to pppd, then
  412. PPP will negotiate the address with the peer.  This is the preferred
  413. mechanism of operation.  Probably the only time you should specify an
  414. IP address as an argument to pppd is if you are assigned your own IP
  415. address by your system administrator.  Otherwise, sit back and let PPP
  416. do the work for you.
  417.  
  418.  
  419. A Typical PPP Session
  420. =====================
  421.  
  422. A tyipcal PPP session begins when you log into your system.  From a
  423. terminal window, you will run your dial script by typing its name at
  424. the prompt.  If you use the Workspace manager, you can double click on
  425. the scripts icon.  This will start the chat process that will dial the
  426. modem and log into the remote system.  It will then turn control over
  427. to pppd.  If your script is successful (as described in the
  428. "Determining if the link is actually up" section), you will be all
  429. set.  All your apps, OmniWeb, FTP, telnet, etc should work.
  430.  
  431. Once you are through using the connection, you can close down the PPP
  432. link by executing the ppp down script.  Again, this can be done by
  433. typing the name of the pppdown script in a terminal window, or double
  434. clicking on the appropriate icon in the Workspace manager.  At this
  435. point, ppp will terminate the phone connection and pppd will die off.
  436.  
  437. You may start and kill the ppp session as many times as you like while
  438. you are logged on.  However, if you do not kill the PPP session, it
  439. will not die once you log out.  Thus your telephone will remain off
  440. the hook and your computer will remain connected to the net until you
  441. log back in and shut down the connection.  Turning off the computer
  442. will obviously close the connection.
  443.  
  444.  
  445. Name Resolution
  446. ===============
  447.  
  448. Once you have a ppp connection up, you may notice that your machine
  449. will not be able to resolve the names of machines to their IP
  450. addresses.  You can check this by trying to telnet to a machine outside
  451. your local domain.  If "telnet <IP address of machine>" is successful,
  452. but "telnet <machinename>" is not, then your name resolution is not
  453. configured correctly. The fix is to edit the file /etc/resolv.conf.
  454. This file contains two important items.  The first is your domain
  455. name.  This is the name that is automatically tacked on to a computer
  456. name if you don't specify the complete name.  For example if my domain
  457. is 'cps.msu.edu' and I say 'telnet sidney', the computer will try
  458. 'telnet sidney.cps.msu.edu' (although, it will not print this name on
  459. the command line).
  460.  
  461. The second thing is a list of name servers.  These should be local to
  462. your ppp provider.  Your network administrator will be able to provide
  463. you with the appropriate addresses. There are default name servers to
  464. use in case the local provider is not responding.  An example file
  465. might look like:
  466.  
  467. ----------------------------------------------------------------------
  468. domain cps.msu.edu
  469.  
  470. #
  471. # Insert local name servers here
  472. #
  473.  
  474.  
  475. #
  476. # MSU name servers 
  477. #
  478. nameserver 35.8.2.41
  479. nameserver 35.8.2.41
  480. nameserver 128.247.160.56
  481.  
  482. #
  483. # Other servers -- hopefully something will work if needed
  484. #shadooby.cc.umich.edu
  485. nameserver 35.1.1.91
  486. #ns.nasa.gov
  487. nameserver 128.102.16.10
  488. ----------------------------------------------------------------------
  489.  
  490. You will need to reboot your computer for the new nameservers to take
  491. effect.
  492.  
  493.  
  494. Making startup and shutdown scripts
  495. ===================================
  496.  
  497. By this time, I'm assuming that PPP has been successfully installed.
  498. However, there are a few more steps that you must perform so that
  499. using PPP (now and with future upgrades) will be convenient and easy.
  500. These steps are optional, but they are highly recommended.
  501.  
  502. Make scripts 'pppup' and 'pppdown' that bring up and shutdown PPP
  503. connections.  There are a number of example scripts that you can copy
  504. and modify.  Reading the man page for 'chat' will help you understand
  505. these scripts. You should note that once these scripts are made, you
  506. probably won't need to change them for future upgrades to PPP.
  507.  
  508. One note that you should be VERY careful about.  These file are shell
  509. scripts.  This means that the contents are executed in a shell just as
  510. if you had typed them in by hand.  You must make sure that any
  511. characters that are treated specially by the shell (such as < > | \ )
  512. are inside quotation marks ("").  Otherwise, they will be interpreted
  513. by the shell in a manner that is probably to your dislike.  For
  514. example, if your peer sends you a prompt like MSUnet> you must add it
  515. to the chat portion of your script like "MSUnet>".
  516.  
  517. In order to ensure that these scripts are not removed or modified when
  518. new versions of PPP are installed, you should copy all important
  519. scripts into a new directory.  I suggest /usr/local/ppp/scripts.  This
  520. directory will not be modified during installation. Further, as you
  521. did earlier for the important binaries, you may want to add important
  522. scripts to a directory that is in the default UNIX Search Path.  The
  523. mechanism for doing this is as follows.  Suppose you have a script
  524. 'pppup' (found in /usr/local/ppp/scripts) that you want to be
  525. available on your command line.  You could execute the commands:
  526.   /bin/mkdirs -o root -g wheel -m 755 /usr/local/bin
  527.   ln -s /usr/local/ppp/scripts/pppup /usr/local/bin
  528.  
  529. Once you log out and log back in, this script will be available.  If
  530. you want to be able to call this script from a non-root account, you
  531. need to modify the permission on the file to make it suid root.
  532. Please note that this can be a potential security hazard.  See your
  533. system administrator for more details.
  534.  
  535.  
  536. Directory Structure
  537. ===================
  538.  
  539. In order to support different versions of PPP, and to provide a safe
  540. upgrade path, the installer installs all files under a subdirectory
  541. named /usr/local/ppp/ppp-2.2-x.x.x  where x.x.x is replaced with the
  542. current version.  Multiple versions can exist simultaneously.  Under
  543. each version, further subdirectories are created (bin, man, examples,
  544. src, etc...).  These contain the actual code.
  545.  
  546. To facilitate easy access to all files in any one particular version,
  547. there is a file named '/usr/local/ppp/version' that is a symbolic link
  548. to the desired PPP version directory.  Furthermore, symbolic links
  549. /usr/local/ppp/[bin,man,examples,reloc,...]
  550. actually point to ./version/[bin,man,examples,reloc...].
  551.  
  552. With this configuration, you can have a fixed pathname that will
  553. always point to the selected version.  For example, if you are using
  554. version 0.3.3 then the pathname:
  555.  
  556.    /usr/local/ppp/bin/pppd
  557.      -will become-
  558.    /usr/local/ppp/./version/bin/pppd
  559.      -which becomes-
  560.    /usr/local/ppp/ppp-2.2-0.3.3/bin/pppd
  561.  
  562.  
  563. One link is created outside the /usr/local/ppp hierarchy.  /etc/ppp is
  564. a link that points to /usr/local/ppp/etc.
  565.  
  566.  
  567. How to Switch between different installed versions of PPP
  568. =========================================================
  569.  
  570. To switch between different version of an installed PPP, you only need
  571. to modify the link /usr/local/ppp/version.  Suppose you want to use
  572. PPP-2.2-0.3.3.  Here are the steps to switch:
  573.       cd /usr/local/ppp
  574.  
  575.    If /usr/local/ppp/version already exists, remove it:
  576.       rm -f ./version
  577.  
  578.    Now create the link pointing to the desired version:
  579.       ln -s ./ppp-2.2-0.3.3 ./version
  580.  
  581.  
  582. You will need to reboot so that the correct LKS is loaded and linked
  583. against the kernel.
  584.  
  585.  
  586. Deinstalling PPP
  587. ================
  588.  
  589. The installer package will deinstall PPP as well as install it.
  590. However, in order to support upgrades, the installer package will not
  591. remove all files that it may have initially created.   The directories
  592. /usr/local/ppp/etc and /usr/local/ppp/scripts will not be modified.
  593. Thus it is safe to keep your dial scripts there.  Further, the
  594. installer package will not modify the links in /usr/local/ppp/ or
  595. /etc/ppp.
  596.  
  597. After de-installation, you may need to update the version link. See
  598. the section "How to Switch between different installed versions of
  599. PPP" for directions on how to do this.
  600.  
  601. As mentioned above, of particular interest for most people is the
  602. 'defaultroute' option to pppd.  If you have a standalone machine, then
  603. all your foreign traffic must go to the peer.  Remember to add the
  604. 'defaultroute' option to pppd in your startup scripts if necessary (or
  605. place it in the /etc/ppp/options file).
  606.  
  607. Troubleshooting
  608. ===============
  609.  
  610. The NeXT port of ppp-2.2 is stable. However, the PD ppp-2.2 is
  611. still evolving.  To find out the latest status of the port, see:
  612.   http://www.thoughtport.com:8080/PPP/
  613.  
  614. Any time that you have a bug report to send, please include your
  615. hardware type and the LKS version number in all reports.  This number
  616. may be found in the file /usr/adm/messages (once the LKS has been
  617. installed). Also, for most questions, it is best to append a copy of
  618. the /usr/adm/ppp2.2.log file.  Bug reports should be sent to
  619. perkins@cps.msu.edu.
  620.  
  621. There are some common problems that people have.  I have listed them
  622. here:
  623. ======================================================================
  624. 1) pppd bombs out with an error similar to:
  625.  Jan 26 14:46:25 localhost pppd[256]: Connected...
  626.  Jan 26 14:46:26 localhost pppd[256]: ioctl(PPPIOCGUNIT): Inappropriate ioctl for device
  627.  Jan 26 14:46:26 localhost pppd[256]: Exit.
  628.  
  629. This is typically the result of using the wrong LKS with pppd.  Some
  630. versions of PPP installed the LKS (ppp_reloc) in
  631. /usr/lib/kern_loader/ppp and some in /usr/local/ppp/reloc.  The second
  632. is going to be the standard place for installation from now on.  Make
  633. sure that your /etc/rc.local is loading the correct version of the LKS
  634. and make sure you are really calling the correct pppd for use with the
  635. LKS that you loaded.
  636.  
  637. ======================================================================
  638.  
  639. 2) PPP works fine, but when the link is up, netinfo sleeps when you
  640.    try to print or send mail.
  641.  
  642. You'll see this problem if you don't have a route from your "hostname"
  643. to localhost.  In essence, your host doesn't know how to "get back to
  644. itself".  My guess is that you didn't follow the installation
  645. instructions and you chose an IP address different than 127.0.0.1.
  646. There is a fix! ;) Do this in your rc.local:
  647.  
  648. route add your_host_name localhost 0
  649.  
  650. (with the appropriate substitution of your_host_name) Without it,
  651. netinfo will sleep when trying to connect to the local domain.  You
  652. will need to reboot or perform this command manually (as root) for it
  653. to take affect.
  654.  
  655. Many thanks to:
  656.   Scott Bender 
  657.   Pete French
  658.   Terence Parr   
  659. for help on this one.
  660.  
  661. ======================================================================
  662.  
  663. 3) People who are trying to set up a NeXT as a PPP server that
  664.    they dial into often complain that they can make a connection, but
  665.    the remote machine can only ping the server.  No other packets
  666.    work.
  667.  
  668. Check out the 'proxyarp' option to pppd.  Servers (connected to their
  669. LAN) must proxyarp for the remote address (i.e. the address of the
  670. machine dialing in).  Further, read the file ./NeXT/README.NeXT (not
  671. this file) for more information on proxyarp.
  672.  
  673. ======================================================================
  674.  
  675. 4) You pppd/chat dials the modem but you cannot get a negotiation
  676.    to start.  The /usr/adm/ppp2.2.log file shows something similar
  677.    to:
  678.  
  679.   Mar 13 12:02:41 crystal pppd[243]: sent [LCP ConfReq id=0x1 <pcomp> <accomp>]
  680.   Mar 13 12:02:44 crystal pppd[243]: sent [LCP ConfReq id=0x1 <pcomp> <accomp>]
  681.   Mar 13 12:02:47 crystal pppd[243]: sent [LCP ConfReq id=0x1 <pcomp> <accomp>]
  682.   Mar 13 12:02:51 crystal pppd[243]: sent [LCP ConfReq id=0x1 <pcomp> <accomp>]
  683.   Mar 13 12:02:54 crystal pppd[243]: sent [LCP ConfReq id=0x1 <pcomp> <accomp>]
  684.   Mar 13 12:02:57 crystal pppd[243]: sent [LCP ConfReq id=0x1 <pcomp> <accomp>]
  685.   Mar 13 12:03:00 crystal pppd[243]: sent [LCP ConfReq id=0x1 <pcomp> <accomp>]
  686.   Mar 13 12:03:03 crystal pppd[243]: sent [LCP ConfReq id=0x1 <pcomp> <accomp>]
  687.   Mar 13 12:03:06 crystal pppd[243]: sent [LCP ConfReq id=0x1 <pcomp> <accomp>]
  688.   Mar 13 12:03:09 crystal pppd[243]: sent [LCP ConfReq id=0x1 <pcomp> <accomp>]
  689.   Mar 13 12:03:12 crystal pppd[243]: LCP: timeout sending Config-Requests
  690.   Mar 13 12:03:12 crystal pppd[243]: Connection terminated.
  691.   Mar 13 12:03:12 crystal pppd[243]: Serial link is not 8-bit clean:
  692.   Mar 13 12:03:12 crystal pppd[243]: All received characters had bit 7 set to 0
  693.  
  694. This is a common problem.  It is typically the result of a failure to
  695. properly start the remote PPP process.  Make sure you add the '-v'
  696. option to chat (in your dial script) and then check the output of
  697. /usr/adm/ppp2.2.log to see why chat failed to start the remote PPP
  698. process.
  699.  
  700. ======================================================================
  701.  
  702. 5) Your LCP sessions get into an infinite loop while trying to
  703.    negotiate the magic numer.  Alternately, every LCP echo you send
  704.    is accompanied with a message saying that "our own echo reply was
  705.    received".  I'm not sure why some systems have this trouble, but
  706.    the solution is to turn off magic number negotiation at your end. 
  707.    Add the '-mn' flag to pppd.
  708.  
  709. ======================================================================
  710.  
  711. 6) NXHosting applications over PPP fails.  I don't know why this 
  712.    happens.  Rest assured, that I and others do have it working.
  713.    The most obvious things to check are that you have your system set
  714.    up as a public window server.  Also, make sure that you reset the
  715.    nmserver in /etc/ppp/ip-up (see the example ip-up file).  If it
  716.    still doesn't work, you might want to add your peer to your
  717.    /etc/hosts.equiv file.  I don't know if that has anything to do
  718.    with it or not, but I don't know why some people can't NXHost
  719.    and others can.
  720.  
  721.  
  722. Updates
  723. =======
  724.  
  725. You may also want to join the mailing list for PPP.  This will keep
  726. you informed of new releases and will provide an arena for discussing
  727. problems with the NeXT specific PPP port.  To add yourself to the list
  728. (or for any other administrative requests), send an email message to:
  729.     listproc@listproc.thoughtport.com
  730. with no subject and message body consisting of:
  731.     subscribe nextppp Stephen J. Perkins
  732. (please use your own name ;). To send mail to all the participants on
  733. the list, address your messages to:
  734.        nextppp@listproc.thoughtport.com
  735.  
  736. If you want announcements only, there is a second "announcements only"
  737. list.  To subscribe to this, you may use the alternate body:
  738.     subscribe nextppp-announce Stephen J. Perkins
  739. You don't need to subscribe to both.  All announcements are forwarded
  740. to the regular list.
  741.  
  742. Security
  743. ========
  744.  
  745. Security issues are not dealt with in this document.  Please
  746. note that the pppd file is installed suid root.  This is a potential
  747. security hazard.
  748.  
  749.  
  750.  
  751. Noted bugs
  752. ==========
  753.  
  754. There have been various problems reported when trying to install LKSs
  755. the way NeXT intended (i.e. placing them in /usr/lib/kern_loader/* and
  756. modifying /etc/kern_loader.conf). The main problem seems to be that
  757. after modifying /etc/iftab, /etc/rc.net (on NSFIP) will not correctly
  758. configure the interfaces.  This means that booting under NSFIP will
  759. hang. So, for the time, it is suggested that you install the package
  760. manually and load the LKS in /etc/rc.local.
  761.  
  762.  
  763. Modem Configuration
  764. ===================
  765.  
  766. It is important to use hardware flow control if you use a high speed
  767. modem. On my supra V.32bis modem, the command to use Hardware Flow
  768. Control is 'AT&K3'.
  769.  
  770. Also, you will probably want to set your modem so that when the DTR is
  771. dropped, the modem will disconnect.  On my modem the command is
  772. 'AT&D2' This setting disables auto-answer so if you want to allow
  773. dialins, you must read your modem manual to determine the correct
  774. setting.
  775.  
  776.  
  777. Finally
  778. =======
  779.  
  780. Thanks go to Dino Bagdadi <dino@ex-nihilo.com> for helping to maintain
  781. this README file
  782.  
  783.